home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 11 / QRZ Ham Radio Callsign Database - Volume 11.iso / files / packet / ad16dis.exe / README < prev    next >
Text File  |  1992-12-31  |  15KB  |  316 lines
  1.                    README file for ARES/DATA  Version 1.6
  2.  
  3. Welcome to ARES/DATA!  Your diskette contains the following files:
  4.  
  5. README          (This file itself)
  6.  
  7. DOCUMENTATION FILES:
  8.  
  9.         USERMAN.DOC     Packet operator full user manual
  10.         QUIKREF.DOC     Quick Reference Card for the packet operator
  11.         DRSI.DOC        Notes on the DRSI PC*PA packet adapter
  12.         SYSOP.DOC       Summary of SYSOP procedures and commands
  13.                         - READ THIS BEFORE ATTEMPTING TO RUN ARES/DATA
  14.         G8BPQ.DOC       How to use the BPQ switch and KISS TNCs
  15.         CONFIG.DOC      Notes on the config file
  16.         ARESDA01.PAP    Revised text of paper on previous version, 0.1
  17.         ARESDA10.PAP    Revised text of paper on previous version, 1.0
  18.  
  19.         INPUT.HLP
  20.         SEARCH.HLP
  21.         SUMMARY.HLP       These six files are short reminders of the A/D
  22.         LIST.HLP          syntax and functions.  Put them in the \PUBLIC
  23.         CHANGE.HLP        subdirectory so that users can download them.
  24.         CONFBRGE.HLP
  25.  
  26. ARESDATA.CFG      An example configuration file
  27. STARTUP.TN1       An example startup file for a WA8DED TNC-1
  28. STARTUP.PCP       An example startup file for a DRSI PC*PA board
  29. STARTUP.P87       An example startup file for an AEA PK-87 w/ DED firmware
  30. STARTUP.TN2       An example startup file for a TNC-2 with DED firmware
  31. INFO              An example INFO file for ARES/Data - put in \PUBLIC
  32.  
  33. ARESDATA.BAT      The startup batch file for running the program
  34. ARESDA16.EXE      The ARES/DATA program version 1.6
  35.                     Searches available on all 4 index fields
  36.                     Generated for 10,000 record database
  37. AD16-3.EXE        ARES/Data program with searches for fields 1, 2, or 3 only
  38. AD16-2.EXE        ARES/Data program with searches for fields 1, or 2    only
  39. AD16-1.EXE        ARES/Data program with searches for field  1          only
  40.                   (These three versions of the program may not be present on
  41.                    your disk.  If you want them, contact us.)
  42.  
  43. MBBIOS.COM        The MBBIOS memory-resident program for handling serial ports
  44. MBBCONFG.EXE      The configuration program for MBBIOS
  45.  
  46. STARTBPQ.BAT      Startup file for G8BPQ switch code.
  47. BPQCFG.TXT        Configuration file for G8BPQ switch (example, v 4.05).
  48.  
  49. ZAPDB.BAT         A batch file to move the current database files to
  50.                       another set of names and start anew with an empty
  51.                       database
  52.  
  53.                   These files describe commands for TNC's using WA8DED
  54.                         firmware:
  55. TNC1DED.DOC       Documentation for the WA8DED TNC-1 Firmware Version 1.3
  56. TNC2DED.DOC       Documentation for the WA8DED TNC-2 Firmware Version 2.5
  57. PK87DED.DOC       Documentation for the WA8DED AEA PK-87 Firmware
  58.  
  59.  
  60.  
  61.           Introduction and Overview for ARES/Data Version 1.6
  62.  
  63.  
  64.  
  65.                               ARES/Data
  66.  
  67.            A Packet-Radio Database for Emergency Communications
  68.  
  69.  
  70.  
  71. I.  INTRODUCTION
  72.  
  73. ARES/Data is basically a multiple-connect, multiple-port specialized bulletin
  74. board system with a conference bridge that is tailored to store and retrieve
  75. basic information about people, places, or things in an emergency or disaster.
  76. The program is a generalized form of the FINDER program (Family Information
  77. Database for Emergency Responders, by WN6I and N6KL, 1987).  Although ARES/Data
  78. allows access to the database via packet radio, the program can also operate
  79. stand-alone without any packet radio access.  The actual operating mode is
  80. chosen by the system operator when the ARES/Data program is started.
  81.  
  82. ARES/Data is a system designed for management of information during a
  83. widespread emergency that overloads normal communications channels.  The
  84. program is conceived to be flexible, so that it can be used without
  85. change for both small and large disasters to organize information about
  86. victims, evacuees, or even ham radio operators.  Examples of situations
  87. in which ARES/Data could be used are (i) registration of individuals at
  88. Red Cross shelters, (ii) patient/victim tracking in a multiple casualty
  89. incident, (iii) maintaining staffing information about hams assigned to
  90. an emergency, (iv) listings of road closures or damage reports, and so
  91. forth.  With alternate power sources and their own frequencies, Amateur
  92. Radio Operators can provide the ARES/Data service without tying up
  93. critical communications channels or relying on commercial power.
  94.  
  95. References:
  96. FINDER: Proc. of the Sixth ARRL Computer Networking Conf., p.134 (1987).
  97. ARES/Data 0.1: Proc. of the Seventh ARRL Comp. Net. Conf., p.141 (1988).
  98. ARES/Data 1.0: Proc. of the Eighth ARRL Comp. Net. Conf., p. 134 (1989).
  99. Public Service Column in QST, December, 1990, p. 75.
  100.  
  101. II. ARES/Data SYSTEM OVERVIEW
  102.  
  103. A.  Three Major Elements
  104.  
  105. There are three major elements to the ARES/Data system:
  106.  
  107.   o ARES/Data software and database (at one centrally located computer)
  108.   o Remote packet stations connected to the central node
  109.   o Conference Bridge
  110.  
  111. The central element of the ARES/Data system is the ARES/Data database
  112. program running on an IBM PC or compatible.  The ARES/Data program
  113. collects and collates current information about people (or other items)
  114. according to the needs of the incident.  The sysop at this computer can
  115. execute all database functions if necessary; it is not required that a
  116. TNC be connected to the computer.
  117.  
  118. If remote access is desired to the information in the database, this
  119. computer may be connected to a packet radio channel through up to four
  120. ports, each of which can be either a TNC with WA8DED firmware or a DRSI
  121. PC*PA packet radio adapter.  In this manner, other remote packet
  122. stations can connect to the ARES/Data machine and thus gain access to
  123. the stored information.  This information can be updated or queried by
  124. the sysop or any of the remote packet stations that are all
  125. simultaneously connected to the main database station.  The data access
  126. occurs by exchanging updates or queries in a simple, precise, and
  127. well-defined format.  A remote packet operator can both enter data into
  128. the system and execute searches for specific pieces of information.
  129.  
  130. During all of this, all of the connected stations and the sysop can
  131. communicate with each other by using a simple "tell" command.  This
  132. "conference bridge" actually implements a star-shaped network in which
  133. the central database station relays all of the message traffic.
  134.  
  135. III.  ACKNOWLEDGEMENTS
  136.  
  137. Since the ARES/Data concept is a generalization of the FINDER system,
  138. the deliberations of the FINDER committee in the Santa Clara Valley
  139. Section of the ARRL have contributed to the present form of ARES/Data.
  140. In addition, our thanks also go to all the ham radio operators in the
  141. Santa Clara Valley Section that have participated in the various alpha
  142. and beta tests of the FINDER and ARES/Data systems.  We also greatly
  143. appreciate the comments and suggestions we have received from hams all
  144. over the world who are using ARES/Data.
  145.  
  146. IV. Version 1.1 Differences
  147.  
  148. Everything you may already know about ARES/Data Version 1.0 still
  149. holds true for Version 1.1.   Version 1.1 fixes some minor bugs, and
  150. provides three new features:
  151.  
  152. 1. STATUS command:  Provides a brief system status, i.e., the current
  153.   LABELS settings, current WIDTHS settings (see below), and the current
  154.   database size.
  155.  
  156. 2. Origin Indicator:
  157.   (Thanks to Pierre Cornelis, ON7PC for this very good idea):
  158.   At the beginning of the MESSAGE field, there will now always be an
  159.   indication of which station last updated each record.  The station
  160.   callsign (or the word "SYSOP") will appear here, so that in case of
  161.   data entry errors, or other questions, everyone can know who made
  162.   which entry.  An example record:
  163.  
  164.   Date/Time LName   FName Call  Phone     Message
  165.   27/1234:  PALMER, DAVE, N6KL, 555-1299, <W6XYZ> DAVE CAN LOAN A RADIO
  166.  
  167.   The origin indicator is fully automatic.
  168.  
  169. 3. WIDTHS command.
  170.  
  171.   The Widths command allows you to more neatly format output data
  172.   on the screen.  It doesn't change the data in any way, but provides
  173.   a way for the column output to "look right".  If the value for any
  174.   field is shorter than the defined WIDTH for that field, then when
  175.   that record is displayed, spaces will be used to try and keep the
  176.   fields aligned on the display.  If a given value is longer than the
  177.   specified WIDTH, then all of the value is displayed, and the
  178.   following fields will likely not be aligned neatly.   (But for most
  179.   records they would be).   Set the WIDTHS anytime you wish; typically
  180.   when you change the meanings of the data base fields when you use the
  181.   LABELS command.  The syntax for the WIDTHS command is very similar to
  182.   that for the LABELS command:
  183.  
  184.   Find out the current WIDTHS:
  185.       widths
  186.  
  187.   Set the widths, so that Field1 has 10 characters, Field2 has 6,
  188.   Field3 has 8, and Field4 has 10:
  189.       widths=10,6,8,10
  190.  
  191.   If you set the widths this way, then output might now look like this:
  192.  
  193. Recno  DT/Time   LName      FName  Call     Phone      Message
  194.    1   27/1234:  PALMER,    DAVE,  N6KL,    555-1299,  <W6XYZ> DAVE ENROUTE
  195.    2   27/0001:  MAXIM,     HIRAM, W1AW,    555-1551,  <SYSOP>
  196.    3   27/0002:  VANDERMEULEN-SMITH, PETE, K6ABC, 555-0911, <W0XXX>
  197.  
  198.   So the last name in record number 3, above, does not fit inside a width of
  199.   10 characters, so the whole value is displayed, and the rest of record 3
  200.   is not well aligned.   Still, records 1, and 2, and other records might
  201.   be displayed more neatly.
  202.  
  203.   This WIDTHS command does call for a little bit higher data traffic, so
  204.   if this is not desired, reset the WIDTHS command to behave as before by
  205.   specifying a width of "*":     Use the command: "WIDTHS=*,*,*,*".
  206.   You cannot set the widths to a value greater than 20.
  207.  
  208. V. Version 1.2 Differences
  209.  
  210. Everything you may already know about ARES/Data Version 1.0 and 1.1 still holds
  211. true for Version 1.2.  Version 1.2 fixes a database bug that occurs for
  212. databases over 1000 records, fixes several smaller bugs that could produce
  213. run-time errors, and adds a DIR command which allows a user to list the files
  214. available for download from the public directory.
  215.  
  216. Some users who have very large databases (namely the hams working with the Los
  217. Angeles Marathon) expressed an interest in increasing the speed of the IMPORT
  218. command.  Version 1.2 has significantly improved IMPORT speeds due in part to
  219. the fact that the IMPORT command no longer copies each imported record to the
  220. JOURNAL file (ARESDATA.JRN), but instead places a notation like this:
  221.  
  222. ;Imported file: UPDATE5.IMP at 1900 on 27
  223.  
  224. Another way to speed up IMPORT at the expense of indexing is to reduce the
  225. number of index files.  Versions of the program that index fields 1-3, 1-2, and
  226. only 1 are included on the distribution diskette.  Do not mix usage of these
  227. versions of the program with databases and indices created with ARESDA12.EXE.
  228.  
  229. Also, regular BACKUPS may be disabled by setting the backup interval to 0
  230. in the ARESDATA.CFG file.
  231.  
  232. VI. Version 1.3 Differences
  233.  
  234. Everything you may already know about ARES/Data Versions 1.0-1.2 still holds
  235. true for Version 1.3.  Version 1.3 fixes a nasty bug that caused the database
  236. to start sending the same packet out again and again in an indefinite loop.
  237. This bug only appeared quasi-randomly when long records and messages were
  238. in use.  Thanks to John Leakley, WB9SMM, for bringing this one to our
  239. attention.
  240.  
  241. One new command has been added to the configuraton file ARESDATA.CFG:  logall,
  242. which causes every packet received from the remote stations to be echoed to
  243. the sysop screen.  New sysop commands "logallon" and "logalloff" turn this
  244. feature on and off during program execution.  Another new sysop command is
  245. "rawimport filename", which allows importing of database data in the standard
  246. input format:  Field1, Field2, Field3, Field4, Msg.
  247.  
  248. Various small changes were made in the documentation to make things clearer,
  249. as a result of feedback from interested hams.  One important item:  be sure
  250. the remotely connected stations set PACLEN to a value larger than the maximum
  251. input line length you expect to use.  This is because ARES/Data processes each
  252. incoming packet as a COMPLETE transaction.  If PACLEN is set too small for a
  253. remote station, his/her TNC may send several packets for one input line, which
  254. results in gibberish to the program.
  255.  
  256. VII. Version 1.4 Differences
  257.  
  258. Several users pointed out that with GET of long files or "l all"
  259. situations, the resulting TNC BUSY error would cause part of the
  260. downloaded data to be lost.  To remedy this, the program detects TNC
  261. BUSY conditions and halts polling until the condition clears.  This
  262. means that no data will be lost and sending of the long file will
  263. continue.  To other users, the system will appear to be busy for awhile
  264. until this condition clears.  Read the comments in SYSOP.DOC.
  265.  
  266. We also fragmented the user manual into a set of .HLP files for download
  267. from the public subdirectory.  This effectively makes more of the
  268. ARES/Data documentation available online.  Other small bugs were fixed,
  269. for example, in the results of the "dir" command.
  270.  
  271. VIII. Version 1.5 Differences
  272.  
  273. Version 1.5 allows the ARES/Data program to run "on top of" the G8BPQ
  274. switch, version 4.01.  PK-232, PK-87/88, and other non-DED TNC users,
  275. please note!  This means that ANY KISS TNC can be used at the main
  276. database station, AND that a full NET/ROM-style G8BPQ switch is provided
  277. automatically.  Read G8BPQ.DOC for details on how to set up your BPQ
  278. switch so that ARES/Data becomes a new "application" that is made
  279. available when a user connects to the switch.  Thanks to John Wiseman
  280. for making this important modification to his switch code, and to N1BEE
  281. for his help in modifying the software interrupt used by the module
  282. DEDHOST.EXE.  Implementation of the BPQ interface forms most of the
  283. bulk of the changes for Version 1.5.
  284.  
  285. We also removed a bug in the DIR command that caused the last character
  286. of long filenames to not be sent to the connected station, and a bug
  287. in the processing of text sent to the sysop screen when you use ARES/Data
  288. to connect out to another BBS system.
  289.  
  290. IX. Version 1.6 Differences:
  291.  
  292. Not many changes, except for documentation on how to use the BPQ switch
  293. to be able to use ARES/Data with KISS TNC's.  We added a database
  294. parameter, "readonly", to prevent remote entry of erroneous data when
  295. the database is of this type.  We also added support for 16-channel DED
  296. EPROMs (I think - not sure!).  We also stopped sending out the BPQ
  297. switch code.  Since new and improved versions of this code are appearing
  298. all the time, you must get your own, recent copy.
  299.  
  300.  
  301. We hope you find ARES/Data to be helpful!  Since we are now both new
  302. daddies, detailed additional hacking of this program will probably not
  303. occur in the near future.
  304.  
  305.  
  306. 73, Dave Palmer / N6KL @ ???? in Colorado
  307.     Weo Moerner / WN6I @ K3MC
  308.  
  309. August 4, 1989    (Version 1.0)
  310. December 1, 1989  (Version 1.1)
  311. March 3, 1990     (Version 1.2)
  312. October 7, 1990   (Version 1.3)
  313. December 5, 1990  (Version 1.4)
  314. January 20, 1991  (Version 1.5)
  315. December 31, 1992 (Version 1.6)
  316.